home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / asmbatch.arc / ASMBATCH.DOC < prev    next >
Text File  |  1986-06-12  |  8KB  |  159 lines
  1. ASM2COM.BAT
  2.  
  3.      This  batch  file  provides  an automated method of producing a COM 
  4. file from a single assembly language source file.  In  addition  to  the 
  5. COM  file,  a  LST  file  is also generated.  The OBJ and EXE files (by-
  6. products of the process) are deleted when no longer needed.  Other files 
  7. are not generated.  
  8.  
  9.      ASM2COM does some rudimentary input checking to insure  the  source 
  10. is not accidentally destroyed or that the processors are not invoked for 
  11. nonexistent  files.  Any  options  specified (field 2) are assumed to be 
  12. for the assembler.  Options  are  not  checked,  just  applied.  The  /N 
  13. option is always defined to suppress the generation of symbol tables (as 
  14. I generally find the printout of little use).  
  15.  
  16.      Following  the assembler invocation,  ERRORLEVEL 1 is checked.  The 
  17. IBM Macro Assembler (and for all I know versions of the Microsoft  Macro 
  18. Assembler  after  1.27)  will  set  the  ERRORLEVEL  flag  if errors are 
  19. detected.  The following ECHO and PAUSE statements, REM'd out, provide a 
  20. similar function if the assembler does not set the ERRORLEVEL flag.  
  21.  
  22.      To invoke the  assembly  process,  the  user  submits  a  statement 
  23. patterned as follows: 
  24.                             ASM2COM filename [options]
  25. where  "filename"  is  the  file  name  of  the  assembly source WITH NO 
  26. EXTENSION!  "[options]" is an optional field consisting of one  or  more 
  27. parameters to the assembler (without any imbedded spaces).  Assuming the 
  28. file exists, a COM file will be produced as described above.  
  29.  
  30. ASM2EXE.BAT
  31.  
  32.      This  batch  file  provides  an automated method of producing a EXE 
  33. file from a single assembly language source file.  In  addition  to  the 
  34. EXE  file,  a LST file is also generated.  The OBJ file (a by-product of 
  35. the  process)  is  deleted  after  the  linking.  Other  files  are  not 
  36. generated.  
  37.  
  38.      ASM2EXE  does  some rudimentary input checking to insure the source 
  39. is not accidentally destroyed or that the processors are not invoked for 
  40. nonexistent files. (Assembler parameters, such as /N, must be hard coded 
  41. in the batch file if desired.) Any field 2 specifications are assumed to 
  42. be for the linker.  The specifications are not checked, just applied.  
  43.  
  44.      Following the assembler invocation,  ERRORLEVEL 1 is  checked.  The 
  45. IBM  Macro Assembler (and for all I know versions of the Microsoft Macro 
  46. Assembler after 1.27)  will  set  the  ERRORLEVEL  flag  if  errors  are 
  47. detected.  The following ECHO and PAUSE statements, REM'd out, provide a 
  48. similar function if the assembler does not set the ERRORLEVEL flag.  
  49.  
  50.      ASM2EXE  will accept an optional field for the linker (LINK).  If a 
  51. linker option is specified (such as /H to produce an EXE  file  for  use 
  52. with a BASIC program), this option field will be provided to the linker.  
  53. If a library name (with no extension) is specified in field 2, the field 
  54. is  supplied  to  the  linker  as a library name (with no linker options 
  55. supported). No checking is done on the second field with correctness the 
  56. sole responsibility of the user.  
  57.  
  58.      To invoke the  assembly  process,  the  user  submits  a  statement 
  59. patterned as follows: 
  60.                             ASM2EXE filename
  61. or
  62.                            ASM2EXE filename /H
  63. or 
  64.                         ASM2EXE filename libname
  65. where  "filename"  is the file name of the assembly source and "libname" 
  66. is the name of a single library file--BOTH WITH NO  EXTENSION!  Assuming 
  67. the files exist, an EXE file will be produced as described above.  
  68. 
  69. ASM2CREF.BAT
  70.  
  71.      This  batch  file provides an automated method of producing a cross 
  72. reference listing from  a  single  assembly  language  source  file.  In 
  73. addition  to the cross reference listing,  a LST file is also generated.  
  74. The .CRF file (a by-product of the process) is deleted after use.  Other 
  75. files are not generated.  
  76.  
  77.      ASM2CREF does some rudimentary input checking to insure the  source 
  78. is not accidentally destroyed or that the processors are not invoked for 
  79. nonexistent  files.  Any  options  specified (field 2) are assumed to be 
  80. for the assembler.  Options are not checked, just applied.  
  81.  
  82.      Following the assembler invocation,  ERRORLEVEL 1 is  checked.  The 
  83. IBM  Macro Assembler (and for all I know versions of the Microsoft Macro 
  84. Assembler after 1.27)  will  set  the  ERRORLEVEL  flag  if  errors  are 
  85. detected.  The following ECHO and PAUSE statements, REM'd out, provide a 
  86. similar function if the assembler does not set the ERRORLEVEL flag.  
  87.  
  88.      To  invoke  the  cross  reference  listing  process,   a  statement 
  89. patterned after the following is submitted: 
  90.                        ASM2CREF filename [options]
  91. where "filename" is the filename (no extension) of the file for which  a 
  92. cross  reference  listing  is  desired and "[options]" are any assembler 
  93. parameters desired.  The output files will have extensions  of  LST  for 
  94. the  assembler  listing  and REF for the output from the cross reference 
  95. program CREF.EXE.  
  96. 
  97. ASM2LIB.BAT
  98.  
  99.      ASM2LIB is intended to provide a more convenient method of handling 
  100. common object  code  library  file  activities.  Where  possible,  error 
  101. checking  (and  double  checking  what  the  user really wants to do) is 
  102. performed.  
  103.  
  104.      To  invoke the library manager,  a statement patterned after one of 
  105. the following show be submitted: 
  106.                              ASM2LIB libname
  107. or 
  108.                         ASM2LIB libname filename
  109. where "libname" is the name of a library and "filename" is the  name  of 
  110. an  assembly  language  source  file  (neither  filename  should have an 
  111. extension--the proper extensions are assumed).  When invoked,  a menu of 
  112. choices  is  displayed.  Selection  is  made by pressing the numeric key 
  113. corresponding to the execution choice.  
  114.  
  115. 0) Create library file
  116.      This procedure will  create  a  new  (empty)  library  file.  If  a 
  117.      library  file  of the specified name already exists,  a query is to 
  118.      determine if the file should be replaced.  If the response  is  "Y" 
  119.      (either  upper  or  lower case),  then the existing file is renamed 
  120.      with an  extension  of  "BAK".  (If  a  BAK  file  already  exists, 
  121.      execution is terminated with nothing changed.) 
  122.  
  123. 1) Review existing library file
  124.      This  procedure  lists the existing entries in a specified library.  
  125.      For convenience,  the DOS MORE  command  is  used  to  control  the 
  126.      listing  on  the  screen.  (A hard copy is produced in REVIEW.LST).  
  127.      Depending on the user, the MORE might be replaced with a 
  128.                            COPY REVIEW.LST PRN
  129.      or a favorite file to screen listing program.
  130.  
  131. 2) Assemble and add to library
  132.      This procedure assembles the  "filename"  and  adds  the  OBJ  file 
  133.      produced  to  "libname"  replacing any existing entry of that name.  
  134.      The same checking done for ASM2COM and ASM2EXE is also  done  here.  
  135.      The OBJ file is also deleted after being added to the library.  
  136.  
  137. 3) Delete entry from library
  138.      This procedure deletes the "filename" entry from the library. (Just 
  139.      in  case,  one  last "Are you sure?" query is made of the user.  As 
  140.      with creation, "Y" permits deletion.) 
  141.  
  142. Notes:
  143.      1.  QUERY.COM displays a comment and  expects  a  single  character 
  144.         response.  Digits  0-9  or  Y/N  are valid inputs.  Output is an 
  145.         ERRORLEVEL corresponding to the digit or a one if the  input  is 
  146.         "Y".  Any other response results in a prompt requesting entry of 
  147.         a valid prompt.  
  148.  
  149.      2.  LIBSETUP.COM pokes "Y///" into the IBM PC keyboard buffer which 
  150.         is what LIB.EXE is looking for when  a  library  file  is  being 
  151.         created.  THIS ROUTINE MAY NOT WORK FOR SO-CALLED COMPATIBLES!  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.